home *** CD-ROM | disk | FTP | other *** search
/ MIDICraft's MIDINET CD-ROM / MIDICraft's MIDINET CD-ROM.iso / DOSUTILS / MIDIMAP.DOC < prev    next >
Text File  |  1996-11-26  |  4KB  |  127 lines
  1.         ******************************
  2.             MIDIMAP v1.0
  3.     
  4.           maps channel numbers of midi binaries
  5.               by Guenter Nagler 
  6.                 1996 
  7.           (gnagler@ihm.tu-graz.ac.at)
  8.         ******************************
  9.  
  10. [0] FEATURES
  11.     + reads a binary midi file
  12.     + maps channel numbers (1-16)
  13.     + writes a binary midi file
  14.  
  15. [1] BACKGROUND
  16. My earlier program midi2gm can map channels but does other modification
  17. to non-gm files too.
  18. This utility only maps channel numbers and copies the rest of the midi data.
  19. It can be used for non-general-midi compatible midi files.
  20.  
  21. [2] FILES DESCRIPTION
  22.  
  23. MIDIMAP.EXE.........converter program
  24. MIDIMAP.DOC.........this file, showing usage of MIDIMAP.EXE
  25. MIDIIO.HPP..........header file for a c++ midi parser
  26. MIDIIO.CPP..........source code for a c++ midi parser
  27. MIDIMAP.CPP.........c++ source code for modifying midi files
  28. MIDIMAP.MAK.........make file for project
  29. MIDIMAP.CFG.........compiler options for make
  30. MIDIMAP.PRJ.........compiler project for Borland (tm) c++ compilers
  31. only MIDIMAP.EXE is required to run program
  32.  
  33. [3] COPYRIGHT
  34.  
  35. MIDIMAP (c) 1996 was created by Guenter Nagler.
  36.  
  37. MIDIMAP is free and may be used as you wish with this one exception:
  38.  
  39.     You may NOT charge any fee or derive any profit for distribution
  40.     of MIDIMAP.  Thus, you may NOT sell or bundle MIDIMAP with any
  41.     product in a retail environment (shareware disk distribution, CD-ROM,
  42.     etc.) without permission of the author.
  43.  
  44. You may give MIDIMAP to your friends, upload it to a BBS, or ftp it to
  45. another internet site, as long as you don't charge anything for it.
  46.  
  47. [4] DISCLAIMER
  48.  
  49. MIDIMAP was designed to handle 100% compatible midi files.
  50. Its parser was tested with 600 different midi files but I 
  51. can not say if each 100% midi compatible midi file can be 
  52. correctly converted.
  53. So I give no guarantees of the results, especially with non 100% 
  54. compatible midi files.
  55. If you find a midi file that you think to be 100% compatible midi
  56. that is not correctly converted, please send a sample file to 
  57. gnagler@ihm.tu-graz.ac.at . 
  58.  
  59. Use MIDIMAP at your own risk.  Anything you do with MIDIMAP is your
  60. responsibility, and not the author's.  Any damage caused to any person,
  61. computer, software, hardware, company, or business by running MIDIMAP
  62. is your responsibility, and the author will not be liable.
  63.  
  64. If you don't understand these terms, or are not sure of something, or
  65. are afraid something bad might come of using MIDIMAP, don't  use  it!
  66. You are here forewarned.
  67.  
  68. [5] INSTALLATION
  69.  
  70. [MSDOS]
  71. Simply copy MIDIMAP.EXE in a directory that is in your path.
  72. When you start the program without arguments
  73.  
  74. [UNIX]
  75. compile sources with your C++ compiler (e.g. GNU Compiler g++):
  76.  
  77. g++ -o MIDIMAP MIDIMAP.cpp midiio.cpp
  78.  
  79. and run program
  80.  
  81. $ MIDIMAP
  82.  
  83. C:\> MIDIMAP
  84.  
  85. you should get the usage text (see next section)
  86.  
  87. [6] USAGE
  88.  
  89. usage: MIDIMAP [-q][-mapchannel #[-#] #] input.mid output.mid
  90.  
  91. The parts in brackets [...] are optional.
  92.  
  93. The program MIDIMAP allows following option:
  94. -version    get program version
  95. -q      be quiet,  program does not show the changes
  96.  
  97. -mapchannel #[-#] #  map all channel dependent commands from channels #-# to channel #
  98.         (first #-# (1-16) are source, second # (1-16) is destination)
  99.  
  100. Warning:
  101.   Do not expect that MIDIMAP will produce a copy of the original
  102.   file! MIDI allows to encode its commands in different ways without 
  103.   changing the semantic of the notes (It is allowed to compress the 
  104.   midi file by ommiting redunant command bytes, but it is no duty).
  105.   MIDIMAP only compresses note on/off command bytes for higher
  106.   compatibility.
  107.  
  108. [8] SUGGESTIONS / COMMENTS / BUG REPORTS / QUESTIONS
  109.  
  110.          WWW:    http://hgiicm.tu-graz.ac.at/Cpub
  111.           contains all my dos/unix midi programs
  112.          EMAIL:  gnagler@ihm.tu-graz.ac.at
  113.  
  114. [9] USE
  115.  
  116. example: map drum channel from extended midi to general midi
  117.  
  118.    MIDIMAP -map 16 10 original.mid copy.mid
  119.  
  120. example: map a list of drum channels used on channels 10-16 to general midi
  121.  
  122.    MIDIMAP -map 10-16 10 original.mid copy.mid
  123.  
  124. Hint: Use miditrk (see [8]) to show the available tracks and their 
  125.     channel number.
  126.  
  127.